

    \filetitle{dbnames}{List of database entries filtered by name and/or class}{dbase/dbnames}

	\paragraph{Syntax}

\begin{verbatim}
List = dbnames(D,...)
\end{verbatim}

\paragraph{Input arguments}

\begin{itemize}
\tightlist
\item
  \texttt{D} {[} struct {]} - Input database.
\end{itemize}

\paragraph{Output arguments}

\begin{itemize}
\tightlist
\item
  \texttt{List} {[} cellstr {]} - List of input database entries that
  pass the name or class test.
\end{itemize}

\paragraph{Options}

\begin{itemize}
\item
  \texttt{\textquotesingle{}nameFilter=\textquotesingle{}} {[} cellstr
  \textbar{} char \textbar{} rexp \textbar{} \emph{\texttt{@all}} {]} -
  List of names or regular expression against which the database entry
  names will be matched; \texttt{@all} means all names will be matched.
\item
  \texttt{\textquotesingle{}classFilter=\textquotesingle{}} {[} cellstr
  \textbar{} char \textbar{} rexp \textbar{} \emph{\texttt{@all}} {]} -
  List of names or regular expression against which the database entry
  class names will be matched; \texttt{@all} means all classes will be
  matched.
\end{itemize}

\paragraph{Description}

\paragraph{Example}

Notice the differences in the following calls to \texttt{dbnames}:

\begin{verbatim}
dbnames(d,'nameFilter=','L_')
\end{verbatim}

matches all names that contain
\texttt{\textquotesingle{}L\_\textquotesingle{}} (at the beginning, in
the middle, or at the end of the string), such as
\texttt{\textquotesingle{}L\_A\textquotesingle{}},
\texttt{\textquotesingle{}DL\_A\textquotesingle{}},
\texttt{\textquotesingle{}XL\_\textquotesingle{}}, or just
\texttt{\textquotesingle{}L\_\textquotesingle{}}.

\begin{verbatim}
dbnames(d,'nameFilter=','^L_')
\end{verbatim}

matches all names that start with
\texttt{\textquotesingle{}L\_\textquotesingle{}}, such as
\texttt{\textquotesingle{}L\_A\textquotesingle{}} or
\texttt{\textquotesingle{}L\_\textquotesingle{}}, but not
\texttt{\textquotesingle{}DL\_A\textquotesingle{}}. Finally,

\begin{verbatim}
dbnames(d,'nameFilter=','^L_.')
\end{verbatim}

matches all names that start with
\texttt{\textquotesingle{}L\_\textquotesingle{}} and have at least one
more character after that, such as
\texttt{\textquotesingle{}L\_A\textquotesingle{}} but not
\texttt{\textquotesingle{}L\_\textquotesingle{}} or
\texttt{\textquotesingle{}L\_RX\textquotesingle{}}.


